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PREFACE 


This reference guide for the National Industrial Basic Language Interpreter (NIBL, pronounced "nibble") is a 
version of TINY BASIC; refer to Doctor Dobbs Journal, Volume 1, January 1976. NIBL is intended for moderate- 
speed input/output and control applications utilizing either a SC/MP or a SC/MP-II microprocessor. 


Included in the NIBL Reference Guide is information pertaining to NIBL program-entry, program control, and 
program content. The appendices provide information on NIBL Formal Grammar, NIBL Error Messages anc 
Descriptions, and "BAGELS" — A simple NIBL game. 


Versions of NIBL are available for both SC/MP (2-microsecond microcycle) and SC/MP-I (1-microsecond 
microcycle). Versions for these two processors differ only in delay constants contained within their Teletype 
driver routines. These Teletype drivers contain software timing loops. For SC/MP-II, two standard products 
are available: 


© ISP-8F/351 Eight 512 x 8 (MM5214) ROMs (see figure 1-1) 
* ISP-8F/352 Two 2K x 8 (MM2316A) ROMs (see figure 1-2) 


For either SC/MP or SC/MP-II, paper tape versions are available through COMPUTE, the National Micro- 
processor Users Group Newsletter. Following are the order numbers for these versions: 


e SLO043A-P for SC/MP 

© SLO43A-N for SC/MP-I 
The material within this publication is subject to change without notice. Changes will be reported in COMPUTE. 
Copies of this publication and other National Semiconductor publications may be obtained from the National 
Semiconductor sales office or the distributor serving your locality. 
Related Publications: 


e SC/MP Data Sheet, ISP-8A/500D Single-Chip 8-bit Microprocessor — Publication Number 
420305227-001 — No charge. * 


e SC/MP-II Data Sheet, ISP-8A/600 Single-Chip 8-bit (N-Channel) Microprocessor — Publication 
Number 426305290-001 — No charge. * 


e SC/MP Technical Description — Publication Number 4200079 — Cost $3. * 


@ SC/MP Assembly Language Programming Manual — Order Number ISP-8S/994Y — Cost $10, 
order from local distributor. 


® SC/MP Kit Users Manual — Publication Number 4200113 — Not available separately; supplied 
in SC/MP Kit. 


e Dr. Dobb's Journal of Computer Calisthenics and Orthodontia — Volume 1, Number 1, January 1976 
and Number 10, November 1976. 


PCC 
Box Number E 
Menlo Park, CA 94025 


r) SC/MP Microprocessor Applications Handbook — Publication Number 420305239-001A — No 
charge. * 


e SC/MP Low Cost Development System (LCDS) Users Manual — Publication Number 4200105A — 
Cost $10, order from local distributor. 


* Contact: Marketing Services 
National Semiconductor Corporation 
2900 Semiconductor Drive 
Santa Clara, California 95051 


or 


Telephone: (408) 737-5142 
®) Registered trademark of the Teletype Corporation 
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Chapter 1 


GENERAL INFORMATION 


1.1 INTRODUCTION 


The National Industrial Basic Language (NIBL) provides the user with a version of the TINY BASIC Programming 
Language intended for moderate-speed input/output and control applications utilizing either a SC/MP or a 
SC/MP-Il1. 


1.2 SYSTEM DESCRIPTION 


Because NIBL initializes in a logically clear state, the first requirement is to supply a program; refer to 
chapter 2 for a detailed discussion of PROGRAM ENTRY. Chapter 2 also contains descriptions of various 
initialization commands and their uses. 


Chapter 3 provides explanations of NIBL variable names, relational operators, expressions, standard arith- 
metic and logical operators, and decimal and hexadecimal constants, and a discussion of several functions 
which may be included in NIBL arithmetic expressions. Chapter 4 includes descriptions of input/output and 
assignment and control statements. Chapter 5 provides a discussion of the indirect operator. 


The last two chapters (chapters 6 and 7) include discussions of multiple statements on a single line, multiple- 
page handling, string handling, and explanations of the LINK, REMARK and END Statements. 


The NIBL formal grammar, NIBL error messages and descriptions, and "BAGELS" — a simple NIBL game — 
are included in appendices A, B, and C, respectively. 


1.3 HARDWARE CONFIGURATION 


1.3.1 Minimum Hardware Configuration 


The minimum hardware configuration required to support the NIBL Interpreter is as follows; also refer to 
figures 1-1 and 1-2. 

a. SC/MP Central Processing Unit (CPU), crystal, and support logic. 

b. 110-Baud ASCII terminal interface. 

c. 4K-by-8 Read-Only Memory (ROM) (0-FFF) for NIBL memory. 


d. 2K-by-8 Read-Write Memory (RAM) (1000-17FF) for user memory (allows approximately 
60 average NIBL line statements). 


e. Model 33 ASR Teletype (IT'TY) or similar terminal. 
f. Power supplies (+5, -12 volts). 


Users who do not wish to build a system from scratch can obtain items a through d above already assembled and 
tested in the form of the SC/MP Low Cost Development System (ISP-8P/301), the 4K-by-8 ROM/PROM Card 
(ISP-8C/004P), and the 2K-by-8 RAM Card (ISP-8C/002). The blank MM5204Q PROMs (included in the 
ISP-8C/004P) then may be programmed with NIBL using the paper tape that is available from COMPUTE, the 
Microprocessor Users Group newsletter. 


NOTE 


The following SC/MP Status Register bits for Teletype 
interfaces are not available to the user's NIBL program: 
User Flag 0, User Flag 1, and Sense Bit B. 


1.3.2 Additional Memory 


Another 2K bytes of RAM (1800-1F FF) will expand the storage capacity to accommodate programs of approxi- 
mately 160 lines. The total 4K bytes of RAM hereafter is referred to as PAGE 1. NIBL allows the user to 
add on six more 4K bytes of pages, providing a total of 28K bytes of user memory that can be used to store 
NIBL programs. Each 4K bytes of user memory can contain a separate NIBL program, and control can be 
transferred from one page to another during execution. 


1.3.3 Using a SC/MP-II 


lf a SC/MP-II is used, a 4.0-megahertz crystal is required because the SC/MP-II increased speed-of-cperation 
can be up to a maximum of twice that of the SC/MP speed-of-operation. The delay parameters in the Teletype 
Input/Output Routines differ between versions of NIBL operating on SC/MP and SC/MP-Il. The COMPUTE 
Users Library has two versions of NIBL, for SC/MP and SC/MP-f: the version released and supported by 
National Semiconductor will run only on SC/MP-I. 
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Chapter 2 


PROGRAM ENTRY AND CONTROL 


2.1 PROGRAM ENTRY 


NIBL initializes in a logically clear state so that the first requirement is to supply a program. This is accom- 
plished either by typing in numbered lines, or by reading in a previously prepared program through the Paper 
Tape Reader. NIBL doesn't recognize the difference between these two methods — it will read characters from 
the paper tape if the Reader is ON; otherwise, the only input will be through the Keyboard. As is customary 
with Teletypes, there is no distinction between tape and keyboard input, so typing while the Reader is running 
will produce errors. 


2.1.1 Prior to Program Entry 


Before entering a new program, type the command [NEw] . This procedure ensures that NIBL is ready to accept 
a new program. 


2.1.2 Entering Program Lines 


Lines may be entered in whatever order is convenient; the actual order in the program is determined by the line 
number, which must begin each line that is to be placed in the program — and not by the order in which the lines 
are received. Leave an interval of at least 10 lines between Lise numbers because it may be necessary to insert 
lines later; there is no way to renumber lines except to retype them. Leaving gaps in the line numbering is 
reasonable since there are 32K possible line numbers. 


2.1.3 Punctuation with Blanks 


Punctuation with blanks is according to taste, as long as keywords are not broken up. Thus, though few blanks 
are required, and all are stored with the program, blanks to provide clarity should be included. 


2.1.4 Additional Proper Procedures 


A line without a number executes immediately, but entering a number without a line will delete that line, if it 
exists. This is permissible since it is the only way to dispose of a specific line; however, if the user starts to 
type a line number and then changes his mind, he must be sure to hit a » NOT the Carriage 
Return ER) Key, as it may cause a good line to disappear or be replaced a mangled line.. NIBL doesn't 
check the correctness of lines as they are entered, so a mangled line will act as a hidden mine which will blow 
up the program when it attempts to execute. 


2.1.5 Control Characters 


There are certain control characters which cannot appear in a NIBL text. These are described as follows: 


| CONTROL/U. | Typing this character causes the current line to be 
deleted. 


Typing this character causes NIBL to resume accepting 
program lines or immediate commands. Use 
CONTROL/C to abort program execution from an input 
statement response. 


CONTROL/C. 


2-1 


SHIFT/O (Back-Arrow). This character deletes the last character typed in (except 
for another back-arrow), and may be used repetitively. 


CONTROL/H (Back-Space). This character is identical in function to SHIFT/O, and 
is intended for use with video terminals. It echoes as 
back-space/space/back-space. 


Carriage Return. | This character terminates the current line and enters 
| it to the NIBL system. 


The Feed and Null Characters are echoed at the Teletype by NIBL, but are ignored. This allows the user to 
see a program by listing it with the Paper Tape Punch turned ON; the tape can be entered to NIBL at any 
e through the Paper Tape Reader. 


Program execution can be halted by pressing any key; however, NIBL checks for this only between each state- 


ment, so to halt program execution, the BREAK key on the Teletype is pressed. Pressing any key while NIBL 
is listing a user's program will cause the listing to be terminated. 


2.1.6 Program Entry Summary 


e A line without a number executes immediately. 
® A line with a number is inserted in order in the program. 
e Line numbers must be from 0 to 32767. 


e No blanks in keywords (LET, IF, THEN, GOTO, GOSUB, GO, TO, SUB, RETURN, INPUT, 
PRINT, LIST, CLEAR, RUN, and so on). 


e Blanks outside keywords are optional. 

e SHIFT/O (Back-arrow) deletes the last character typed. 

e CONTROL/H (Backspace) has the same function as SHIFT/O (for use with CRT's). 
@ CONTROL/U deletes the entire line. 


2.2 PROGRAM CONTROL 
2.2.1 NIBL Commands 


2.2.1.1 NEW Command 
The command should be typed on the TTY &. to entering a program, but the user must be reminded 


that any existing program is lost after entering , the Carriage Return Key. Fortunately, the NEW 
command is not legal as a line in a NIBL program. : 


Typing followed by a Page Number clears the program in that PAGE. 


2.2.1.2 RUN and GOTO Commands 


Using the RUN Command is not the only way to start a program; that is, if 10 is the lowest line number, 
GOTO 10] will accomplish the same thing. If it is desired to start at some line, say 110, not the first line 


inthe program, just type instead of [RUN]. 


The RUN Command clears all internal stacks and variables, the GOTO Command does not. 


2.2.1.3 LIST Command 


Typing causes the NIBL program in the current PAGE to be listed in its entirety. If the user wants to 

check around line 110, type | LIST 90] and hit the BREAK key when enough of the program has been listed. Beyond 
its primary use, to display the program, LIST serves, on an ASR-33 Teletype, as the methed for saving a program: 
type [LIST] ; then turn on the Punch; then hit EH , the Carriage Return Key. | 


2.2.1.4 CLEAR Command 


The CLEAR Command will cause all variables (A-Z) to be zeroed. CLEAR also clears all‘the stacks used by 
a NIBL program indirectly; that is, the GOSUB stack, the DO/UNTIL stack, and the FOR/NEXT stack. 


2.2.2 Program Control Summary 


« CLEAR clears all variables (A-Z) and all stacks. 

® NEW deietes the program in PAGE 1 {normal page). 

e NEW n (n is from 2-7) deletes the program in PAGE n. 

e LIST lists the program starting at the lowest line number, or the line number given. 


e RUN starts the program at the lowest line number. 


NOTE 


Repeated pressing cf the BREAK Key interrupts 
execution and returns the system to programming 
mode. 


Chapter 3 


NIBL EXPRESSIONS AND FUNCTIONS 
3.1 EXPRESSIONS 


3.1.1 Variable Names 


In NIBL there are 26 variable names, that is, the single letters of the alphabet. The variables are all 16-bit 
signed INTEGERS; there are no fractions or floating point numbers in NIBL. All numeric constants are decimal 
numbers, except when preceded by a pound sign, ‘'#', in which case the constant is taken to be hexadecimal. 


3.1.2 Relational Operators 


The Relational Operators ("=", "<", ">", "<=", ">=", and "< >") are the standard BASIC types and should 
be self-explanatory, except for '< >', which means "is not equal to". Note that '> <' is illegal. The Relational 
Operators return either 0 (FALSE) or 1 (TRUE) as a result. 


3.1.3 Arithmetic Operators 

The standard operators '+', '-', '/', and '*' are provided. 

Arithmetic is standard 16-bit twos-complement arithmetic. Fractional quotients are truncated, not rounded; 
division by zero induces an error break. The order of evaluation of arithmetic expressions in NIBL is controlled 
by parentheses; operator precedence also influences operations, but is is safer to use many parentheses in 
complicated expressions to avoid confusion. 

3.1.4 Logical Operators 

In addition to the standard arithmetic operators, NIBL provides Logical Operators AND, OR, and NOT. The 


first two are binary operators like * and +; the last is a unary operator like @. These operators perform bitwise 
logical operations on 16-bit arguments, producing 16-bit results. | 


3.1.5 Expression Summary 
e All expressions are 16-bit, twos-complement values. 
e 26 variable names: A through Z. 


s Relational Operators <, >, =, <=, >=,< >. 

e Arithmetic Operators +, -, *, /. 

e Logical Operators AND, OR, NOT. 

e Decimal Constants in the range -32767 to 32767. 


e Hexadecimal Constants denoted by '#' followed by hex digits. 


3.2 FUNCTIONS 


There are several functions which may be included in arithmetic expressions in NIBL. These are described 
as follows. | 


3.2.1 MOD Function 


MOD (a,b) returns the absolute value of the remainder of a/b, where a and b are arbitrary expressions. If b 
is zero, (0), an error break will occur. 


3.2.2 RND Function 


RND (a,b) returns a pseudo-random integer in the range of a through b, inclusive. For the function to work 
correctly, b-a must be less than or equal to 32767 (base 10), and b should be greater than a. 


3.2.3 STAT Function 


STAT returns the value of the SC/MP Status Register (an 8-bit value). Note that STAT may appear on the left 
side of an Assignment Statement as well as on the right side. The Carry and Overflow Flags of the status 
register are usually meaningless, since the NIBL Interpreter itself is continually modifying these flags. The 
Interrupt-Enable Flag cannot be altered by an assignment to STAT (as an example: STAT = #FF); NIBL clears 
that bit when making any assignment to the status register. User Flags 0 and 1 and Sense Bit B are noi available 
to the user's NIBL program for Teletype interfaces. 


3.2.4 TGCP Function 


TOP returns the address of the first byte above the NIBL program in the current Page which is available for 
use. In other words, it is the address of the highest byte in the NIBL program, plus 1. All the memory in the 
current Page, above and including TOP, can be used by the NIBL program as scratch storage. 


3.2.5 PAGE Function 


PAGE is a pseudo-variable (like STAT) which refers to the 4K memory page in which a NIBL program is either 
being edited or run. The only legal values for PAGE are 1 through 7; when a number is assigned to PAGE 
which is outside these limits, only the least significant three bits of the number are used. If the resulting 
value is G, the value 1 is assumed. As an example, PAGE = 3000 would cause PAGE to be set to 1; refer to 
6.2, Multiple-Page Handling, for more information. 


3.2.6 Function Summary 


e RND (a,b) returns the random number in the range a through b. 
e MOD (a,b) returns the remainder of a/b. 
e STAT returns the value of the SC/MP Status Register. 

a) PAGE returns the number of the current Page. 


e TOP returns the highest address of NIBL program in the current Page. 


3.3 HIERARCHY OF OPERATIONS 


The order of performing individual operations within an expression is determined by the hierarchy of operators 
and the use of parentheses. Operations of the same precedence are performed from left to right in an expression, 
Operations within parentheses are performed before operations not in parentheses. The hierarchy (from highest 


to lowest) of operators is as follows: 

NOT, functions, @, ( ) 

*, /, AND 

+, -, OR 

<, >, <=, >=, < > 
For example, the expression 2 + 3 * 4 would have the value 14, because the '*' operator has a higher precedence 
than '+'. Thus, the term 3 * 4 is computed first, giving a result of 12; then the expression 2 + 12 is computed, 


giving the final result of 14. On the other hand, the expression (2 + 3) * 4 would have the value 20, since NIBL 
coraputes the value of the subexpression in parentheses before evaluating the surrounding expression. 


Chapter 4 


INPUT/OUTPUT, ASSIGNMENT, AND CONTROL STATEMENTS 
4.1 INPUT/GUTPUT STATEMENTS 


4.1.1 Executing an Input/Output Statement 


Input of all numbers to NIBL may be accomplished by executing a statement such as 
INPUT A,B 


When this statement is executed, NiIBL prompts the user with a question mark. Now the user types in two 
expressions, separated by commas, which will be assigned to the variables A and B. Thus, a legal response 
to the INPUT statement above wceuid be 


45, #F FCO 
String input is also allowed in NIBL; refer to 6.3, String Handling, for more information. 


Typing Control/C during an INPUT response causes NIBL to abort execution of the program and to return to the 
Edit Mode. 


4.12 Output Statements 


In Output Statements, quoted strings (such as "THIS IS A STRING") are displayed exactly as they appear {with 
the quotes removed). Numbers are printed in decimal format, with either a leading space (for positive numbers) 
or a minus sign, '-', for negative numbers;.and a trailing space for all numbers. A semicolon (;) at the end of 
an Output Statement suppresses the usual Carriage Return with which NIBL terminates the output. 


Strings in memory (such as those generated by a String Input Statement) may also be printed; refer to 6.3, 
String Handling, for more information. 


4.1.3 Input/Output Statement Summary 


e INPUT x 
e INPUT X,Y,Z 

e PRINT “A STRING" 

e PRINT "F=",M*tA 

e PRINT “TAKE",X,"PILLS BEFORE"; 


NOTE 


The semicolon (;) suppresses an otherwise automatic 
Carriage Return after any Output Statement. 


4.2 ASSIGNMENT STATEMENTS 
4.2.1 Assignment Statement Forms 


The 'LET' in an Assignment Statement may be omitted, that is, the execution of the statement is actually 
faster if 'LET' is omitted. 


The left portion of an Assignment Statement may be a simple variable (A-Z), STAT, PAGE, or a memory loca- 
tion, indicated by a @ followed by a variable, number, or an expression in parentheses; refer to chapter 5, 
Indirect Operator, for more information. 


A String Assignment Statement is also allowed by NIBL; refer to 6.3, String Handling, for more information. 


In connection with Assignment Staternents, a property may be noted by means of which conditional assignments 
may be made without using any IF Statements. It hinges on the fact that all predicates, as an example: expres - 
sions such as A >B or (A+3)*5 >100, are actually evaluated to yield a 1 if true, and a 0 if false. Thus, if a 
predicate is enclosed in parentheses, it may be used as a multiplier in a statement such as: 


LET X = A*(A >=0)-A*(A< 0) 


which assigns to X the absolute value of A. 


4.2.2 Assignment Statement Summary 


e LET X=7 

e E=1*R 

e STAT = #70 

e PAGE = PAGE + 1 
° LET @A = 255 

e @(T+36) = #FF 


NOTE 


"LET" is optional in any Assignment Statement. 
4.3 CONTROL STATEMENTS 


4.3.1 Control Statement Construction Allowances 


NIBL, a superset of the originally-proposed TINY BASIC, allows certain constructions in Control Statements 
that are not allowed in larger standard BASIC's. These attractive aberrations are in two areas: 


A.  NIBL allows GOTO or GOSUB to use an arbitrary expression where standard BASIC's would 
allow only a constant statement number; as an example: 


GOTO X+5 
or GOSUB A+(X >Y + 2) 


B. NIBL allows an arbitrary statement to follow an [fF /THEN] rather than a statement number to 
be executed if the predicate is true (as is the rule in standard BASIC's). 


NIBL allows the omission of the THEN, as is also allowed in some larger BASIC's — this is one omission which 
enhances clarity by removing "noise" from the program. 


4-2 


4.3.2 Subroutine Advantages 


For users without any programming background, a brief treatment of a "subroutine" (which is what GOSUB and 
RETURN give to a BASIC) is given. If there is a computation of operation which must be carried out in more 
than one place in the program, the need to repeat the code involved is avoided by setting this code outside of 
the program; (as an example: beyond the last statement of the main program) with an additional statement, 
RETURN, appended. When this has been accomplished such that the first statement of this segregated code 
(now called a subroutine) is, as an example, 1000, the operations it carries out may be invoked by the use of 
a [GOSUB 1000 . The encountering of the RETURN Statement in the 1000 subroutine will cause execution to be 
taken up at the first line following the last executed. Execution of a GOSUB is-usually referred 
to as calling (or invoking) a subroutine. The space saving and consolidation of code which has been alluded to 
here as the advantage of the subroutine, is only the slightest suggestion of the immense utility and organiza- 
tional power of the subroutine concept. 


4.3.3 DO and UNTIL Statements 


NIBL has another contro] structure which is not available in any standard BASIC, TINY or otherwise. This is 
the DO/UNTIL construct, with which program loops may be designed with a minimum of GOTO Statements. The 
overall effect of this feature is to greatly improve the readability, maintainability, and clarity of NIBL programs. 


By enclosing zero or more statements between a DO Statement and an UNTIL <condition> Statement (where 
< condition > is any arbitrary expression), the user causes these statements to be repeated as a group until 
the <condition > evaluates to a non-zero number. As an example of the use of the DO and UNTIL Stateménts, 
a program which prints the prime numbers is listed as follows: 


10 PRINT 1: PRINT 2 


20 IF: t-REM IIS THE NUMBER BEING TESTED 

30 DO 

40 J=1/2:N=1 =REM J I THE LIMIT; N IS THE FACTOR 

50 BO :-REM TRIES TO FIND A DIVISIBLE FACTOR OF I 
60 =N+2 

70 UNTIL (MOD(I, N)=0) OR (N>J) 

80 IF N>J PRINT I :-REM DID NOT FIND A DIVISIBLE FACTOR 

90 I=H2 


100 UNTIL 0 >REM REPEATS THE OUTER LOOP FOREVER 


4.3.4 FOR and NEXT Statements 


NIBL also has FOR and NEXT Statements which are identical to the FOR and NEXT Statements in standard 
BASIC's. As in other BASIC's, the STEP in the FOR Statement is optional, and if it is included, may be 
£ither positive or negative. If the STEP is omitted, a STEP of +1 is assumed. A FOR loop is terminated 
by a NEXT <var> Statement, where <var> is the variable referred to in the FOR Statement which began 
the loop. NIBL causes an error break if the variable in the NEXT Statement does not match that in the 
matching FOR Statement. | 


FOR/NEXT loops may be nested, and NIBL will report an error if the nesting level becomes too deep. Note 
that a FOR loop will be executed at least once, even if the initial value of the control variable already exceeds 
its bounds before starting. As an example of the use of the FOR and NEXT Statements, a program which 
prints a table of random numbers is listed. 


10 
20 
30 
40 
50 
60 
70 
80° 
1000 
1010 
1020 
1030 
1040 
1050 
1060 
1070 
1080 
1090 
1160 
1110 


REM THIS PROGRAM PRINTS A TABLE OF RANDOM NUMBERS, 
REM USING A SUBROUTINE TO FORMAT THE OUTPUT IN ZONES. 
FOR K=1 TO 4 
FOR J=1 TO 8: N=RND(-16000, 16000): GOSUB 1030: NEXT J 
PRINT veer 
NEXT K 
END 
REM 
REM THIS SUBROUTINE PRINTS THE VALUE OF N AND SKIPS 
REM TO THE NEXT PRINT ZONE (FIELD WIDTH = 8). THE 
REM THE VALUES OF N AND 1 ARE DESTROYED. 
PRINT N; 
1=0 | 
DO 
N=N/10: IFH1 
UNTIL N=0 
FOR F-1 TO 6-1 
PRINT " Ne 
NEXT I 
RETURN 


Control Statement Summary 


GO TO 15 or GOTO 15 
GOTO X+5 

GO SUB 100 or GOSUB 100 
RETURN 

IF X+Y >3 THEN GOTO 15 
IF X >3-Y GOTO 15 

IF A=B LET A=B-C 

FOR I= 10 TO 0 STEP -2 
NEXT I 

FOR K=1TO5 

DO: X=X+1: UNTIL (X=10) OR (@X=13) 


4-4 


Chapter 5 


THE INDIRECT OPERATOR 


5.1 INDIRECT OPERATOR USAGE 


The Indirect Operator, a powerful feature, is a NIBL exclusive, at least in the realm of BASIC. It realizes 
the functions of PEEK and POKE operations in other BASIC's, with a less cumbersome syntax, and is a way 
to access absolute memory locations though its applications are not limited to that. In microprocessors such 
as SC/MP, where interfacing is commonly carried out via memory addressing, its utility is especially 
significant. 


Preceding a constant, a variable, or an expression in parentheses by an "at" sign ('@'), causes that constant, 
variable, or expression to be used as an unsigned 16-bit address at which the value is to be obtained or stored. 
Thus, if the input address of some device is #6800 (hexadecimal), then the statement [LET X=@#6800] inputs 
from the device, and, if the output address is #6801, then [LET @#6801=Y | outputs to the device. As another 
example, if it is desired to store a matrix of dimension M x N starting at a location stored in A, then the (I, J)th 
byte of this matrix may be accessed as follows: 


[LET @ (A+ N*(I-1)+ (J-1) =X] 


if the array is to be stored by rows and indexed from (1,1). If indexing from (0,0) is acceptable, as is standard 
in larger BASIC's, and the matrix is to be stored by columns, then the proper assignment is as follows: 


[LET @ (A+1+(J*M)) =X 


NOTE 


The Indirect Operator allows one te access memory 
locations cnly one byte at atime. Thus, the matrix 
defined in the example above is a matrix of one-byte 
elements. An assignment such as would 
actually result in changing the memory location pointed 
to by A to zero, not 256, because only the least signifi- 
cant byte of 256 (which is zero) is stored at that loca- 


tion. 
5.2 INDIRECT OPERATOR SUMMARY 
e Any place a variable, as an example: V, would be legal, the construct "@V" is also legal. 


The meaning of '@V" is the byte located at the memory location whose address is the value 
of V. Thus, if the value of Vis 10, then [LET @V=100] stores a decimal 100 in byte 10 and 
LET W=GV |then sets W to 100. 


e Also legal: 


PRINT @10 
LET E=@(A+10*I+J) 


NOTE 


Parentheses are required when applying @ to an 
expression. 


Chapter 6 
MULTIPLE STATEMENTS, PAGES, AND STRING HANDLING 


6.1 PROGRAM LINE MULTIPLE STATEMENTS 


More than one NIBL statement can be placed on a program line. This is accomplished by placing a colon (*:') 
between the statements to separate them. This practice can improve the readability of programs, and can 
reduce the amount of memory required to store the program. As an example of the use of multiple statements 
on a line, consider the following NIBL line: 


100 PR "FUEL =", X: IF X< 0 PR "YOU BLEW IT": GOTO 32767| 


The first Output (PRINT) Statement is executed; then, if X is negative, the "YOU BLEW IT!" message is 
printed, and NIBL proceeds to the last line in the program (if there is a line 32767). If X had been positive, 
however, the last message would not have been printed, and control would have passed immediately to the 
next numbered line in the program 2fter line 100. 


The above example demonstrates that if the condition in an IF Statement fails, control is transferred to the next 
program line, and anything else on the line is ignored by NIBL. . 


6.2 MULTIPLE PAGE HANDLING 
6.2.1 4K PAGES 


The NIBL system requires RAM from 1000 to 17FF (hex); the RAM, together with the optional RAM from 1800 
to IFFF, comprises PAGE 1. This 4K Page is normally used to store a program; however, NIBL also allows 
the user to add up to 6 more 4K Pages for storing cther programs. These Pages are called PAGES 2-7. 
This section describes briefly how to make use of this hardware-dependent feature of NIBL. 


6.2.2 Transferring PAGE Control 


The pseudo-variable PAGE refers to the 4K Page in which a NIBL program is currently being executed or 
edited. Legal Pages are 1-7; any assignment to PAGE (as an example: PAGE = PAGE + ]) uses only the 

least significant 3 bits of the value as the new page number. PAGE 0 is the same as PAGE 1]. An assign- 
ment to PAGE during program execution causes control to be transferred to the first program line in that 
PAGE, if any. If control is transierred from one Page to another by some other means (that is, via RETURN, 
UNTIL, or NEXT Statements), the correct value of PAGE is automatically updated by NIBL. Page selection 
allows seven completely separate programs to be maintained by the user; however, all programs use the same 
variables and stacks. 


6.2.3 PAGES 2 Through 7 


PAGES 2 through 7 (corresponding to Starting Addresses 2000 to 7000 (hex)) may be ROM. When NIBL is 
run initially, it attempts to initialize all pages, then transfers control to PAGE 2. If PAGE 2 does not 
contain a NIBL program, the value of PAGE will be set tol, and NIBL will immediately prompt with a ('>") 
GREATER THAN sign at the Teletype. If PAGE 2 contains a NIBL program in the proper format, it will be 
executed immediately without the need for the user to tell NIBL anything. 


6.2.4 Moving NIBL Program Into ROM 


Here is how to move a NIBL program into a PROM, once it has been written and entered to the NIBL system 
(assuming the user has an LCDS). The final address of the program is found by typing] PRINT TOR Convert 
the number that NIBL prints into hex for the LCDS. Halt the LCDS, and punch the section of memory containing 
the program in Load Module Format. PAGE 1] programs begin at location NIE (hex); all other Pages start at 
n000, where n is the page number. Once the Load Module is punched, use SPPRO on the PAGE DOS to program 
some PROMs of the users NIBL program. Such a program can be moved from Page to Page, if so desired. 


6.3 STRING HANDLING 


6.3.1] String Input 


String input is accomplished by executing a statement of the form INPUTS F] ,» where F is a factor, syntacti- 
caliy; refer to Appendix A. NIBL prompts with [2]. indicating that the user is to type in a line terminated by 
ER) , the Carriage Return Key. All line editing characters can be used (Backspace, Line Delete, and 50 on). 
The“line is stored in consecutive locations starting at the address stored in F, up to and including the a5: . 


6.3.2 String Output 


An item in an Output (PRINT) Statement can include the form [$F], where F is a factor. This will cause the 
string beginning at the address F to be printed, up to, but not including, the 3) . A Keyboard interrupt will 
also terminate the printing if detected before the 5 ° 


6.3.3 string Assignment 


A statement of the form I$F = "THIS IS A STRING". | causes the characters in quotes to be stored in memory 
starting at the address indicated by F (which is again a factor), with the ES appended to the string. 


6.3.4 String Move 


A statement of the form , where F and G are factors, causes the characters in memory beginning 
with the Address G to be transferred byte-by-byie to memory starting at Address F, until a carriage return is 
detected in the source string, or a Keyboard Interrupt is detected. The last character, normally a carriage 
return, is also copied. A statement such as| $(F+1) = $F] is disastrous unless the user presses the BREAK 
Key very quickly, since it causes the entire contents of the Page pointed to by F to be filled with the first 
character of $F. 


Page wraparound will occur if the user is not careful, but F and G may be in different Pages. 


An example of a program using String Move and Input Statements follows; strings are typically put at the top of 
a program in memory: 


NIBL code 


P; REM MAKES Q POINT TO EMPTY RAM ABOVE TOP OF PROGRAM 
P+10: REM MAKES R POINT TO RAM 10 BYTES ABOVE Q | 


ry 
36 


$Q = "A STRING" 
INPUT $R 


6.3.5 String Handling Summary 
e $T = "THS I A STRING" 
e PRINT $T, $(TOP+72) 
e INPUT $ (U+Z0) 
e | $U = $(TOP + 2*36) 


Chapter 7 


ADDITIONAL STATEMENTS 


7-1 LINK STATEMENT 


LINK < address> causes control to be transferred to the SC/MP Machine Language Routine starting at <address > 
control is transferred by execution of an XPPC P32 instruction. The Machine Language Routine should make sure 
that P3 is restored to its original value in order to return to NIBL (by execution of another XPPC P3 instruction). 
The other pointers may be modified by the routine. Pl's value is unpredictable; P2 points to the start of A-Z 
variable storage. Variables are stored in alphabetically ascending order; two bytes each; low-order byte, then 
high-order byte. 


7-2 REMARK STATEMENT 


The REM Statement is used to insert comments into NIBL programs. When NIBL encounters the word REM as 
the first word in a statement, it skips to the next line in the program. It is wise to insert many comments into 
a program while it is being deveioped. After the program is debugged, the comments can be removed if the 
user requires more space and speed. However, if someone else besides the original programmer must under- 
stand or modify the program someday, those comments can be extremely helpful. 


7-3 END STATEMENT 


The END Statement is useful for inserting breakpoints into a NIBL program while it is being debugged. When 
NIBL encounters an END statement, it prints a break message and the current line number, and returns to edit 

le. Any number of END statements may appear in a program, and the last line in the program does not need 
to be an END Statement. 


Appendix A 


NIBL FORMAL GRAMMAR 


AU items in single quotes are actual symbols in NIBL; all other identifiers are symbols inthe grammar. The 
equals sign "=", means “is defined as"; parentheses are used to group several items together as one item; the 
exclamation point, "!", means an exclusive-or choice between the items on either side of it; the asterisk, "*", 
means zero or more occurrences of the itern to its left; the plus sign, ''+"', means one or more repetitions; the 
question mark, "?", means zero or one cccurrence; and the semicolon, ";"', marks the end of a definition. 


| Nibl-line 


Immediate-statement 
! Program-line 


Immediate-statement = (Command ! Statement) Carriage-return; 
Program-line = (Decimal-number Statement-list Carriage~return) ; 


Command = 'NEW' Decimal-number ? 
! 'CLEAR' 
!*LIST' Decimal-number ? 
1 'RUN' 


Statement-list = Statement (':’ Statement) *; 


Statement = "LET' ? Left-part '=' Rel-exp 

!'*LET' ? '$' Factor '=" (String ! '$' Factor) 
1 'Go' ('TO' ! 'SUB') Rel-exp 
!*RETURN’ 
!(’PR' ! 'PRINT"') Print-list 
! ‘TF! Rel-expr 'THEN' ? Statement 
1 *po' 

! 'UNTIL' Rel-—exp 
' 

! 

t 

1 

1 

' 


— 


'FOR' Variable '=" Rel-exp 'TO' Rel-exp ('‘STEP' Rel-exp) ? 
"NEXT' Variable 

'‘INPUT' (Variable + ! '$' Factor) 

"LINK' Rel-exp | 

'REM' Any-Character~Except-Carriage-Return * 

"END' 


Left-part = (Variable ! '@' Factor ! 'STAT' ! 'PAGE') ; 


Rel-exp = Expression Relop Expression 
! Expression 
’ 
Relop = '<'" ! '<t t=" to tet tot Potyot poryt tar fp tar; 


Expression = Expression Adding-operator Term 
Poqt+t } tt) ? Term 


(Continued on Page A-2) 


Adding-operator = '+' ! '-' 1! 'OR'; 


Term = Term Multiplying-opcrator Factor 
! Factor 


Multiplying-operator = '*' ! '/' ! 'AND'; 


Factor = Variable 

! Decimal-number 
! (' Rel-exp ')' 
! '@' Factor 

! '#' Hex-number 

! "NOT" Factor | 

!''MOD' '"(' Rel-exp ',' Rel-exp ')' 
! 'RND' '"(' Rel-exp ',' Rel-exp ‘)' 
! 'STAT' 

! 'TOP' 

! *PAGE' 


Variable = "At ! "Bt! tech rool. fb ty! tots 
Decimal-number = Decimal-digit + ; 


Decimal-digit = 'O' ! "1" |! f2" ! 1 gt. 


(Decimal-digit 


Hex-digit = 'A' 


Print-item = (String ! Rel-exp ! '$' Factor) ; 


String = '"' Almost-Any-Character ''"® ; 


Spaces are not usually significant in a NIBL program, with the following exceptions: Spaces cannot appear 
within key words (like ‘THEN’ or 'PRINT") or within constants. Also, a variable (like 'A' or 'Z') must be 
followed immediately by a non-alphabetic character to distinguish it from a key word. 


Appendix B 


NIBL ERROR MESSAGES AND DESCRIPTIONS 


Error messages are of the form: 


[EEEE ERROR AT LN] 


where | EEEE|is one of the error codes below, and is the number of the line in which the error was en- 
countered. 


Character after logical end of statement 


CHAR 

DIVO Division by zero 

END" No ending quote on string 

FOR FOR without NEXT 

NEST Nesting limit exceeded in expression, FOR's, GOSUBs, etc. 
NEXT NEXT without FOR 

NOGO No line number corresponding to GOTO or GOSUB 
RTRN RETURN without previous GOSUB 

SNTX Syntax error 

STMT Statement type used improperly 

UNTL UNTIL without DO 

VALU Constant format or value error 

AREA 


No more room left in current page for program 


